﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>使用自适应缓冲</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:12/06/2007 20:50:20-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">使用自适应缓冲</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
		<font color="DarkGray"><!-- [This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]<br/>[Documentation built on $$TIMESTAMP$$]  --> </font> <p /> <p />
	
        <div id="introductionSection" class="section">
    <p>自适应缓冲是 Microsoft SQL Server 2005 JDBC Driver 版本 1.2 的一项新增功能，其作用是在无需服务器游标开销的情况下检索任何类型的大值数据。</p>
    <p>通常，当 Microsoft SQL Server 2005 JDBC Driver 执行查询时，驱动程序会从服务器将所有结果检索到应用程序内存中。尽管这种方法可以最大程度地减少 SQL Server 上的资源占用，但它可能会在 JDBC 应用程序中针对生成非常大的结果的查询引发 <b>OutOfMemoryError</b>。</p>
    <p>为了允许应用程序处理非常大的结果，Microsoft SQL Server 2005 JDBC Driver 版本 1.2 提供了自适应缓冲。应用程序开发人员可能出于以下原因而希望在语句中使用自适应缓冲：</p>
    <ul><li>
        
          <b>查询生成非常大的结果集：</b>应用程序可能执行一个 SELECT 语句，此语句生成的行数超过了应用程序可在内存中存储的行数。在先前的版本中，应用程序必须使用服务器游标才能避免 <b>OutOfMemoryError</b>。而在版本 1.2 中，应用程序可以使用自适应缓冲。借助于自适应缓冲，可以对任意大的结果集执行只进只读传递，而不需要服务器游标。<br />
      </li><li>
        
          <b>查询生成非常大的 </b>
          <a href="eaffcff1-286c-459f-83da-3150778480c9.htm">SQLServerResultSet</a>
          <b> 列或 </b>
          <a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a>
          <b> OUT 参数值：</b>应用程序可能检索单一值（列或 OUT 参数），而此值太大，无法全部进入应用程序内存中。通过自适应缓冲，客户端应用程序可以使用 <b>getAsciiStream</b>、<b>getBinaryStream,</b> 或 <b>getCharacterStream</b> 方法将此类值作为流来进行检索。当应用程序从流中读取数据时，它将从 SQL Server 中检索值。<br />
      </li></ul>
  </div><h1 class="heading">设置自适应缓冲</h1><div id="sectionSection0" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">应用程序可以通过三种方法请求语句执行应使用自适应缓冲：</p>
      <ul xmlns=""><li>
          应用程序可以将连接属性 <b>responseBuffering</b> 设置为“adaptive”（自适应）。有关设置连接属性的详细信息，请参阅<a href="f1b62700-f046-488d-bd6b-a5cd8fc345b7.htm">设置连接属性</a>。<br />
        </li><li>
          应用程序可以使用 <a href="097434fd-2b74-411c-a5ed-eba04481dde5.htm">SQLServerDataSource</a> 对象的 <a href="c9e43ff2-8117-4dca-982d-83c863d0c8e1.htm">setResponseBuffering</a> 方法为通过该 <a href="097434fd-2b74-411c-a5ed-eba04481dde5.htm">SQLServerDataSource</a> 对象创建的所有连接设置响应缓冲模式。<br />
        </li><li>
          应用程序可以使用 <a href="ec24963c-8b51-4838-91e9-1fbfa2347451.htm">SQLServerStatement</a> 类的 <a href="9f489835-6cda-4c8c-b139-079639a169cf.htm">setResponseBuffering</a> 方法为特定的语句对象设置响应缓冲模式。请注意，应用程序必须将此语句对象转换为 <a href="ec24963c-8b51-4838-91e9-1fbfa2347451.htm">SQLServerStatement</a> 才能使用 <a href="9f489835-6cda-4c8c-b139-079639a169cf.htm">setResponseBuffering</a> 方法。<br />
        </li></ul>
      <p xmlns="">当使用 get&lt;类型&gt;Stream 方法读取一次大值，并且 SQL Server 按返回的顺序访问 ResultSet 列和 CallableStatement OUT 参数时，自适应缓冲在处理结果时可以最大程度地减少应用程序内存占用。使用自适应缓冲时：</p>
      <ul xmlns=""><li>
          在 <a href="eaffcff1-286c-459f-83da-3150778480c9.htm">SQLServerResultSet</a> 和 <a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a> 类中定义的 <b>get&lt;Type&gt;Stream</b> 方法默认情况下返回只读取一次的流，尽管可以重置流（如果应用程序已进行标记）。如果应用程序要对流执行 <code>reset</code>，它必须先对该流调用 <code>mark</code> 方法。<br />
        </li><li>
          在 <a href="24170524-e1ab-4e80-8fd1-6688efacfbde.htm">SQLServerClob</a> 和 <a href="88bd8623-889d-4b5d-99ff-c85b32f3ff5c.htm">SQLServerBlob</a> 类中定义的 <b>get&lt;Type&gt;Stream</b> 方法返回的流始终可以重定位至流的开始位置，而不必调用 <code>mark</code> 方法。<br />
        </li></ul>
      <p xmlns="">当应用程序使用自定义缓冲时，由 <b>get&lt;Type&gt;Stream</b> 方法检索的值仅供检索一次。如果您在调用同一列或同一参数的 <b>get&lt;Type&gt;Stream</b> 方法后，试图对同一对象调用任何 <b>get&lt;Type&gt;</b> 方法，则将引发异常并显示消息“数据已访问，不可用于此列或此参数”。</p>
    </content></div><h1 class="heading">将应用程序内存占用减至最小</h1><div id="sectionSection1" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">开发人员应遵循以下重要指南，将应用程序占用的内存减至最小：</p>
      <ul xmlns=""><li>
          避免通过使用连接字符串属性 <b>selectMethod=cursor</b> 来允许应用程序处理非常大的结果集。Microsoft SQL Server 2005 JDBC Driver 版本 1.2 的自适应缓冲功能允许应用程序在不使用服务器游标的情况下处理非常大的只进、只读结果集。<br />
        </li><li>
          通过使用 <b>getAsciiStream</b>、<b>getBinaryStream</b> 或 <b>getCharacterStream</b> 方法（而不使用 <b>getBlob</b> 或 <b>getClob</b> 方法）将大文本或二进制值作为流进行读取。在版本 1.2 中，<a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a> 类提供了新的 <b>get&lt;Type&gt;Stream</b> 方法来实现此目的。<br />
        </li><li>
          确保在 SELECT 语句中将可能具有大值的列放在列列表的最后，并且使用 <a href="eaffcff1-286c-459f-83da-3150778480c9.htm">SQLServerResultSet</a> 的 <b>get&lt;Type&gt;Stream</b> 方法按选择列时的顺序来访问这些列。<br />
        </li><li>
          确保在用来创建 <a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a> 的 SQL 语句的参数列表中，最后声明可能具有大值的 OUT 参数。此外，确保使用 <a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a> 的 <b>get&lt;Type&gt;Stream</b> 方法，按照声明 OUT 参数时的顺序访问这些参数。<br />
        </li><li>
          避免同时对同一连接执行一条以上的语句。如果在处理上一条语句的结果之前执行另一条语句，则可能导致将未处理的结果缓冲到应用程序内存中。<br />
        </li></ul>
    </content></div><span id="seeAlsoSpan"><h1 class="heading">另请参见</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="e1592499-b87b-45ee-bab8-beaba8fde841.htm">借助 JDBC 驱动程序提高性能和可靠性</a><br /><br />
		
		<b>
			
			
		</b>
	</div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />  <span id="fb" class="feedbackcss"> </span> 
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2007 Microsoft Corporation。保留所有权利。
		</a>
 	
	
      </div>
    </div>
  </body>
</html>